HTML.edit 1.7 for Macintosh - ReadMe

HTML.edit ©1994, 1995 Murray M. Altheim, Equinox Development, All Rights Reserved.
Please read the Legaleze section under HTML.edit Help for information regarding copyrights, credits and distribution.


####   Availability    ****

Information on current versions is now available at

   http://ogopogo.nttc.edu/tools/htmledit/HTMLedit.html

Non-beta versions of HTML.edit are distributed worldwide via sumex, umich and their mirrors.

Information on bugs and fixes is available at

   http://ogopogo.nttc.edu/tools/htmledit/bugs.html

Please email any comments or problems you find with this version to the author at

   murray.altheim@nttc.edu


####   NOTES ON HTML.edit v1.7.0:   ****

Also see the section "New Features" under Help. 

No Usage Restrictions
Please note that I have removed the commercial use restriction on HTML.edit. However, all distribution restrictions, copyright and intellectual property protections remain unchanged. Please see the Legaleze section under Help for more information.

Insert Export String --> Insert Custom Entity
Previous versions allowed the insertion of text strings that were optionally translated upon export into date or time information. These strings were in the form "{Abbreviated Date}" using curly brackets. This version now uses an SGML entity-style format as the inserted string, such as "&date;" or "&time;".  Existing documents using the curly bracket strings should be changed to the new format using a global replacement to the new format as shown below:

   Old Format                      New Format
   {Short Date}                     &date;
   {Abbreviated Date}               &abbrevDate;
   {Long Date}                      &longDate;
   {Time}                           &time;
   {Long Time}                      &longTime;

Use the Replace command (under the Utility menu) with the options set to "All Occurrences" and "All Documents". If you are transferring documents between versions of HTML.edit, uncheck the option "Translate Entities on Export" on Import/Export Preferences.

Footers
HTML.edit defines a footer as any text following the <!--FOOT--> tag used as a separator, regardless of whether this tag occurs in the Body or Footer text areas of the editor. The separator is an HTML comment, which should be ignored by WWW browsers, and can be modified from the Preferences card. I use this feature to automatically cue HTML.edit to separate out the footer text on imported documents. Modifying the "footer" of many documents is then simplified.

Help
If you are upgrading from a previous version, please check the "Installing HTML.edit" section in Help, especially if you notice any anomalies with the Futura display font. There is no longer any font suitcase to install.

Note that previous versions of HTML.edit included the HTML documents "Mosaic for X version 2.0 Fill-Out Form Support" (courtesy NCSA) and "HTML and SGML" (which is part of Dave Raggett's HTML 3.0 draft). These online documents are now referenced via the Browse Hotlist submenu under the tool palette's Preview menu.

Hotlist Menu
Please note that the current version does not support semicolons on the Hotlist menu, either in the URL itself or in the displayed menu text.

Miscellaneous
Check the "New Features" Help section as well as the Change History below for details on new features. 


####   Change History   ****

See online Bug List/History document

   http://ogopogo.nttc.edu/tools/htmledit/bugs/html

for extended history.

(1.7d165/1.7.0 1995.09.04)
 - added Balloon Help for many Prefs options
 - speeded up transition between Prefs sections
 - added overflow checking on Index
 - final cleanup for release

(1.7d164 1995.08.31)
 - fixed: resizing label area on Index disabled clicking on scroll bar grey area
 - Index now properly sorts by path (up to six levels deep)
 - fixed problem with displaying multi-line TITLE in Index
 - fixed: wasn't remembering palette locations
 - now displays Label in editor window with popUp selector menu
 - fixed footer utility table resize bug on small windows
 - ALT attribute on IMG now limited to 1024 characters; option to translate <>&" to entities
 - added 'Date & Time' to available custom entities on Utility menu
 - browser Preview (Command-J) now works on Master Headers and Footers
 - added right margin indicator (vertical line) to ruler

(1.7d163 1995.08.24)
 - Command-Option-F displays new Find Tool. Check Balloon Help for description.
 - no longer re-indexes when changing document path or name
 - fixed some field updating problems with Anchor Utility
 - fixed some user-interface uglies with Anchor and Footer Utilities
 - changed user interface details on Element Index, Find, Keywords and URL field
 - Element Index can now be resized vertically using a divider
 - fixed errors in Help documentation on BASE and META
 - fixed relative path bug in URL field on documents selected from URL popUp menu

(1.7d162 1995.08.23)
 - no longer re-indexes when changing path to a file
 - fixed touchlink problem with documents having no set path
 - fixed browser request dialog
 - no binks option on Editor Preferences
 - shift-select multiple documents using up and down arrow keys on Index
 - shift-enter selects the current physical line in editor
 - eliminates any standard bullets (ie., "¥*·¨àÞ") from lists on translation
 - added BODY with attributes to Remove HTML command

(1.7d157 1995.08.17)
 - global replace by specified document label
 - holding down Shift on QuickLink with zero length selection inserts first H1 of target as hypertext
 - holding down Option on QuickLink with zero length selection inserts TITLE of target as hypertext
 - properly handles BODY tags with attributes
 - improved error handling on browser interaction
 - QuickLink to Selected Document now uses wider dialog box when listing TITLEs or pathnames
 - eliminated some globals to save memory

(1.7d151 1995.08.12)
 - fixed freeSize/Editor Size display on Compacting Preferences (now truly in 'K')
 - command-option-B: insert BASE in current document
 - export of Help text: MS Word/HTML version based on d151
 - added "\f" (=form feed) to miniGREP metacharacters
 - added storage of Preferences file name

(1.7d147/b9 1995.08.08)
 - fixed Restore Path from BASE (Import option) handling of BASE elements that refer
   to a directory rather than a document 
 - removed extraneous dialog on Browse
 - changed method of storing path to WWW browser on Browse; now via Set button on Prefs
 - fixed size of disabled Label field on Labels Preferences
 - improved trapping of shift and option keys on shortcuts
 - reorganized Help
 - added "\q" (=quote) to miniGREP metacharacters
 - new Uncomment command (Command-Plus) and reorganized HyperText menu

(1.7d143/b8 1995.08.02)
 - new Paste File command (Edit menu) pastes an imported text file at the insertion point
 - added Convert Tab to "\t" (or other custom string) on Import; tabs are not allowed in HTML

(1.7d141 1995.08.01)
 - new feature to save settings to and restore from a Preferences file
 - added optional WIDTH attribute on PRE, COMPACT attribute on lists (optionKey on menu)
 - implemented Michael Bradshaw's Progression XCMD in place of earlier progress bar
 - added a return character after ADDRESS and list elements
 - now correctly sets the http server name when requested from Editor window
 - Preferences fields now resize properly to fit smaller windows
 - fixed window update bug in navigating to different background after resizing window
 - now hotlist and image library allow commas (semicolons will show up in menu or URL as colons)

(1.7d133 1995.07.26)
 - Export Conversion option: translates characters or strings to entities on export (©, Ÿ, Ž, etc.)
 - fixed some small bugs on Prefs
 - Font menu on Index now hierarchical
 - Insert Entity window now available from Windows menu at any time
 - changed order of conversion on export so that entities in headers/footers will be converted properly
 - finally located the Indexed status bug (the Index didn't always know it needed updating)

(1.7d128/b7 1995.07.09)
 - I think I finally got the URL field working as advertised, both absolutely and relatively
 - now properly clears Anchor Utility's Fragment ID field when selecting from Hotlist
 - now asks for default HTTP server name if not set on opening Anchor Utility
 -  'Set' button on Prefs wasn't setting path correctly; fixed bug in
   drivePath XFCN; was not resetting item delimiter to comma
 - caught a few more missing links in the hypertext Help
 - fixed a few more Index bugs - adding View by Title has been a real headache

(1.7d127/b6 1995.07.07)
 - still a bug in TouchLinks to documents in the same folder: URL incorrect.

(1.7d124 1995.07.05)
 - I don't know about anybody else, but I finally removed that annoying initial
   return character when typing option-return
 - Indexed status was not always being set correctly - I think this bug is now dead
 - fixed named anchor popUp on Anchor Utility by rewriting attribute parser
 - Default Settings bugs fixed
 - Default Settings now only sets to default the visible Preferences section, not all sections
 - Preferences sections now selected via button rather than popUp menu
 - now truncating at 64 character limit on TITLE as per DTD

(1.7d122 1995.07.04)
 - rewrote duplicate label checker: was finding partial word matches
 - fixed document selection bug on Index
 - changed resize window on Prefs to better reflect window size
 - rewrote locator for HEAD insertion point: BASE insertion overlapped other tag if not on own line

(1.7d120/b5 1995.07.02)
 - new Welcome to HTML.edit document
 - now available: a simplified palette option (checkbox on Editor Preferences)
 - rewrote attribute parser to handle single or double quotes as well as extra spaces
   and returns; now also checks for balanced quotes
 - TT is now called "Teletype" not "Typewriter" to match HTML 2.0 DTD (yccch)
 - removed the 2.0 deprecated "LISTING" format from the HTML menu

(1.7d117 1995.06.30)
 - optionally break imported document into separate documents
   at formFeed (ASCII 12) or custom character
 - fixed importer to break document on word boundary when overflowing into footer field
 - added report templates for printing from Index, and enabled printing Index contents

(1.7d115 1995.06.29)
 - added XFCN replacements for nine handlers
 - entity maps no longer stored in memory
 - shrunk size of Entity window about 30% and added © and ¨.
 - added Keywords utility: click on words in document to add to list (used by META)
 - added HTTP-EQUIV popUp menu to META dialog; uses current selection
   if keywords field is empty
 - uses wider dialog box when selecting documents using path or title

(1.7d110 1995.06.26)
 - fixed text resize bug on Clip Library preferences
 - removed "Show Path" buttons from Index and Prefs, and added option to Index popUp menu
   to choose display content of Index: Document Name, Title or Path
 - changed "Glossary" command to "Definition" command to match HTML 2.0 DTD (duh...)

(1.7d107 1995.06.22)
 - last line in Index no longer cut in half -- scroll works properly now too.

(1.7d105/b4 6/18/95)
 - added Restore Path and Insert BASE commands to Index card's popup menu

(1.7d103 1995.06.16)
 - fixed problem with beeping loop on Clip Library
 - option-click on prev or next buttons to view prev or next document name
 - fixed Export As command (now asks for new name)
 - imported documents not part of server path get annoying message
 - added resize box to Preferences card
 - Hotlist, Clip and Image Libraries now import/export to text files
 - Hotlist now imports Mosaic and Netscape bookmark files (Netscape users must "Export" their Hotlist)

(1.7d98 1995.06.14)
 - working on URL popUp (problem with URL text not updating properly)
 - changed Header/Footer toggle icon to Apple Alarm Clock-style latch
 - added horizontal scroll bar to Table Utility
 - fixed SGML Prologue duplications on HTML Language command

(1.7d92 1995.06.10)
 - Hotlist now available from Anchor Utility and Preview menu, and uses HTML anchor format
   to allow for labelling of URLs on menus (you select the hypertext link, and the associated URL is entered).

(1.7d90 1995.06.09)
 - Preview button now a popUp menu supporting browser "OpenURL" preview via BASE element,
   manually entered, or from hotlist. Option-click to simply Preview via old method of opening text file.
 - Jon Pugh confirms problem with disabled text on popUp is due to
   limitation of menu manager - disabled text good thru first 31 lines max

(1.7d88 1995.06.06)
 - updated HPopUpMenu XFCN to 3.3.1; still problem when dealing with large amounts of disabled text
 - still working on Table UtilityÉ
 - fixed bug in elapsed timer: now works properly and works up to 1 year before rolling over
 - updated Palette Help (color and new stuff)
 - fixed bug where after moving application window could hide redisplayed Tool Palette partially under menubar
 - changed "Compact Stack" command to "Compact"

(1.7d83 1995.05.30)
 - added new Table Utility card (Command-Shift-T to go there)
 - Preview now has shortcut Command-J (works from any document, master header or footer)
 - added List Item to HTML Format menu, with shortcut Command-L
 - Clip Library's shortcut now Command-Shift-L

(1.7d76 1995.05.30)
 - rewrote Index and Hilight HTML handlers (Index now much faster, Hilight had bugs);
   added font selection on Hilight
 - HTML Title now uses first <H1> in document as default text
 - added 2 optional attributes as popups on Anchor Utility (using mailbox latch to enlarge)
   ID, URN, REL, REV, TITLE, METHOD
 - fixed a few things to make it load a bit faster

(1.7d73 1995.05.27)
 - Server button on Anchor Utility wasn't updating server URL "sample" field on Prefs
 - checks for existence of BASE element on import and sets target path accordingly
 - added RestorePath handler to recreate fullPathName from existing BASE element
 - Remove HTML now also reconverts entities
 - now maintains selection after Remove HTML, Unwrap, Convert Entities, Reconvert Entities and Table Convert
 - now traps Command-Shift-O (oh); was setting text as outline style
 - Preprocess Text now preprocess, table, entity and paragraph converts; works in reverse on optionkey
 - restores selection on show/hide header & footer and drag header/footer size
 - better handling of return characters on Convert ¦ to <P> (in both directions)
 - Unwrap Text now preserves spaces (ie., returns) between paragraphs

(1.7d72/b3 1995.05.26)
 - fixed problem with URL relative path creation on TouchLink and QuickLink
 - now maintains selection after insertion of link on TouchLink and QuickLink
 - fixed annoying rename attempt on Import from Index card
 - now properly disables unused custom entity items in Utility submenu

(1.7d70/b2 1995.05.25)
 - reimplemented fullSFPack XFCN for getting folder paths due to apparent bug in HC answer folder
 - fixed minor text errors in Help and added shortcut keys to Table Menu graphic on Palette Help
 - fixed bug in Export and Export AsÉ commands from menubar File menu on Index
 - added Duplicate Document command
 - now trapping "help" button and calling HTMLHelp instead of HyperCard Help
 - now trapping "home" and "end" to go to Index and Preferences respectively
 - updated Format palette to match HTML format submenu (and 2.0 DTD)

(1.7d68/b1 1995.05.20)
 - now properly restores selection on redo and disables Undo menu item when appropriate
 - supports META element (under HTML Structure submenu) allowing simplified search attributes:

   <META name="resource-type" content=document>
   <META name="description" content="text description"> 
   <META name="keywords" content="keyword1,keyword2,keyword3">
   <META name="distribution" content=global> 

 - now transfers META elements to <HEAD> section
 - Default Settings button now restores conversion and HTML style tables (no RTF yet)
 - fixed URL creation from URL field on Anchor Utility
 - Anchor Utility now sets URL field on named anchors
 - fixed bug in getAttrList (gets attribute list for popUps, etc.)
   now handles quoted and unquoted attributes and finds unbalanced quotes
 - fixed bug in uniqueness check of Custom Entity names
 - command left arrow to go back through the Help topics you've browsed
 - click on associated document name in Custom Entity table to go there
 - changed Go Master Headers and Footers to selection of specific header or footer
 - table of contents for named anchors within documents
 - fixed bug in character count on imports over 30K

(1.7d64 1995.05.19)
 - prev, next and selected links (Command 7,8 and 9 respectively) now work without
   Anchor Utility, and add correct server folder path when available.
 - added diversion to Utility menu
 - added window size Maximize button

(1.7d63 1995.05.18)
 - added maximize button on Editor window, and changed behavior of window size popUp (no optionkey)
 - added option to change background color of Help
 - new document now asks for name rather than using default "Untitled-x.html"
 - replaced fullSFPack XFCN with HC 2.3 "answer folder"
 - uses URL field as container for creating HREFs on Quick HyperText Link and TouchLink ("HotLink") commands
 - ironed out most of the kinks in TouchLinkª, esp. updating URL field between documents (server path aware)
 - reorganized Help, rewrote some sections
 - added elapsed time counter (wish I'd done that first!)
 - changed appearance of Prefs card to match other backgrounds

(1.7d58 1995.05.16)
 - now avoids nasty recursive loop when inserting document into itself using custom entities
 - new custom entity choice from popUp only changes existing entity after asking -- custom dialog box
 - custom entities now cleaned for spaces, commas, pound (#) signs, extra ampersands and semicolons
   and checked against Latin 1 and existing custom entity lists.

(1.7d55 1995.05.14)
 - modifiable Font menu: new Physical and Semantic Styles tables on Prefs card
 - SGML Prologue popUp menu/table on Prefs card now customizable
 - updated command language to match HTML 2.0 DTD (May 6, 1995 draft)
 - rewrote Footer Utility resize handler
 - popUp on sample text on Footer Utility for font and size
 - added 'Date & Time' format to Footer Utility
 - adding multi-format email address to Footer Utility
 - added Copy fromÉ button to Footer Utility to copy Author/Curator table
 - fixed Clear button on Footer Utility
 - rewrote custom entity handler
 - added 1 pixel drop shadow to all windows for consistency
 - fixed resize bugs on all backgrounds
 - fixed tools palette forgetting its location when hidden

(1.7d50 1995.05.10)
 - PowerMac native version
 - added Format, Form and Table palettes
 - rewrote all palette handling
 - fixed all bg resizing problems due to new XFCN (?)
 - now disallows commas and semicolons in filenames

(1.7d48 1995.05.09)
 - blocked option-tab display of HC tools palette
 - finished up new resize handlers with maximum window size
   limited only by memory: card sizes up to 1024 x 1024.
 - fixed window resize popUps; added Maximize item to resize to current screen (up to 1024 x 1024)
 - new Preprocess Text command (ala Dave Raggett's suggestion) to convert HTML reserved
   characters (genericized Table Convert to accept any table)
 - added Preprocess Text table to Conversion Preferences

(1.7d44 1995.05.04)
 - substituted GrowBox for FullDrag XFCN to allow for less cumbersome window sizing (still need to fix MF)
 - cleaned up small problems and added to Table Conversion commands
 - broke Conversion section into three areas:  Table Conversion, Custom Entity Conversion,
   and RTF Conversion
 - Custom Entity conversion on export now includes documents, not just master headers and footers

(1.7d35 1995.04.30)
 - if a complete heading element (i.e., "<H1>Heading Text</H1>") is selected,
   choosing a heading level will alter the heading level rather than add new tags
 - change Export String curly braces usage to SGML-style custom entities (&date;, &time;, etc.)
 - added new feature: translate SGML-style custom entities on export 
   as contents of a selected master header or footer
 - removed redundant part of Header area popUp menu for consistency with Footer popUp

(1.7d28 1995.04.29)
 - fixed bug with scrolling items in Text Lookup Table - now uses two item table rather
   than two scrolling fields, so now source can be longer string instead of just single character
- removed support for nonstandard <!-- comments > (now follows HTML2.0 spec only)

(1.7d28 1995.04.22)
 - now supports all forms tags
 - Palette Help updated for forms
 - Remove HTML now removes forms tags
 - fixed bug in "Choose a Document" under Go menu on Prefs card

(1.7d20 1995.04.17)
 - now maintains selection when inserting basic tags while Info window is visible
 - added beginning of simple Forms input
 - RTF export now seems to be moving faster than RTF import (simpler)
 - fixed bug in Anchor menu responding to base of hierarchical menu with no item
 - fixed bug in inserting TITLE into middle of <HE<TITLE>AD>

(1.7d17 1995.04.14)
 - fixed problem where path was showing up in document selection dialog
 - fixed thermometer on Hilite Anchors
 - fixed problem on HyperText Link to Selected Document: locktext not working properly
 - eliminated Line Feeds commands; server platform-based auto-filter on import/export (prefs)
 - now overflow text over 30K into footer field on import (new 60K limit on imports)

(1.7d13 1995.04.12)
 - restructured Anchor popUp menu and added Hot Link (working title)
 - added bookmarks feature under Utility popup menu
 - Hotlist & Image Library name now changed to Libraries Preferences
 - added Clip Library window and Edit menu commands (contents on Libraries Preferences)
 - fixed bug in remembering location of tool palette
 - now remembers rect of Info and Clip Library windows
 - changed max window from 640 x 824 to 704 x 720 (same memory req.)